home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / sysext / init / autoblac.sit / AutoBlack Doc < prev    next >
Text File  |  1987-05-20  |  8KB  |  170 lines

  1. AutoBlack(tm) -- The screen saver with a light touch -- User Notes Version 1.5
  2.  
  3. When AutoBlack is installed, after five minutes of user inactivity, the Mac 
  4. screen will go black to prevent burning an image of the desktop (or whatever is 
  5. on the screen) into the phosphor of the CRT.  Any user activity (move the mouse, 
  6. press any key, insert a disk) will immediately restore the current contents of 
  7. the screen display with no waiting for system "update events" to redraw it.  The 
  8. five minute timer restarts from the last time of user activity, and may be set
  9. by the user to any desired value.  As a special feature, there are two built-in 
  10. variants on the delay time.  If the mouse is pushed all the way into the top 
  11. right-hand corner of the screen, the delay is reduced to about two seconds 
  12. regardless of the delay setting, so you can hide the screen in a hurry if you 
  13. need to do that.  Alternatively, if the mouse is pushed all the way into the 
  14. bottom right-hand corner of the screen it takes a couple hours, so if you are 
  15. passively watching computer output you don't need to alter the delay time nor
  16. keep moving the mouse every few minutes.
  17.  
  18. While the screen is turned off an analog clock icon is displayed at random 
  19. positions, to show that the Mac is still turned on.  The clock will show the 
  20. correct time of day if the program running at that time has a normal Macintosh 
  21. interface (that is, it is calling the SystemTask trap from time to time).  If
  22. the clock shows random times, changing every time it is drawn, it is because
  23. you have not set the time and date correctly since you last removed the battery.
  24.  
  25. INSTALLATION
  26. AutoBlack can be installed in any of three ways.  Primarily it is designed to 
  27. install itself in RAM on bootup.  To do this requires that it be present in the 
  28. system folder on your bootup disk.  Alternatively, it can be double-clicked as
  29. an application from any folder.  After it is installed, it is not needed on any 
  30. disk drive, and it will continue to be active no matter what the Mac is doing, 
  31. until you power off, Shut-down or press the Reset button.
  32.  
  33. The preferred method to install this program at bootup is to copy it to the 
  34. system folder of your bootup disk and rename it "MacsBug".  The operating system 
  35. always loads in a file named "MacsBug" (if it is there) before it does anything else, and it is important that AutoBlack be loaded in first, before any RAMdisk 
  36. or even MacsBug itself.  If you need MacsBug to be loaded also, rename it 
  37. "Disassembler" and it will be loaded in after AutoBlack.  Next time you boot up, AutoBlack will install itself in RAM (but the bootup box will say "MacsBug 
  38. installed").
  39.  
  40. AutoBlack is also configured to install as an "INIT" file.  In this mode you can
  41. name it anything you wish; System 3.2 and later versions will look for all INIT
  42. files like AutoBlack in the system folder and start them up as part of its boot
  43. procedure.  If you have other INITs or the real MacsBug in the system folder, 
  44. this may fail.  If you have the 128K ROMs (that is, you are using a double-sided 
  45. internal drive) the INITs are loaded in alphabetical order; you can just rename 
  46. the other INITs so they come later in the alphabet.  If AutoBlack is not able to 
  47. install properly, a dialog will inform you of its failure.  If the AutoBlack
  48. INIT file is named "MacsBug" it is guaranteed to install first, and you will see
  49. both the "MacsBug installed" message and a little notice put up by the INIT.
  50.  
  51. If other INITs, RAMdisks, or immortal desk accessories have not yet overwritten
  52. the memory required by AutoBlack, you can also run it as an application program.
  53. If you double-click on the AutoBlack icon from the Finder, you will normally get
  54. a message "An application cannot be found for this document."  Hold the option
  55. and cloverleaf keys down while double-clicking to avoid this problem.  Or you
  56. can use DeskZap, Fedit, or Resedit to change the file type to "APPL".  This will
  57. result in a different icon (a Mac screen with the familiar hand in front of it);
  58. you can double-click this icon with no impediment.
  59.  
  60. You can run the application any time, even after AutoBlack is installed.  It
  61. allows you to change the delay time from the default five minutes.  Setting the
  62. delay time to zero disables AutoBlack, but you can always run the application
  63. again to start it back up with a new delay time.
  64.  
  65. My preference is to use AutoBlack in the APPL mode, name it "MacsBug", and leave
  66. it in the system folder.  That way it always installs itself at bootup without
  67. requiring manual attention, but I can still easily double-click it to change the
  68. delay setting.
  69.  
  70. HOW IT WORKS
  71. AutoBlack takes over the alternate display area and paints it black (except for 
  72. the clock icon).  Then a small task is installed in the vertical retrace queue 
  73. of the Macintosh (when it also looks at the mouse and keyboard), which counts 
  74. the time since the last user activity.  Once the delay time is exceeded, the 
  75. video hardware is switched to the alternate display.  Any time user activity 
  76. takes place, the display is switched back to the normal display area, and the 
  77. timer is restarted.  The Macintosh software is not told about the switch, so it 
  78. continues to update the normal display area; thus the display is immediately 
  79. current whenever the hardware is switched back.  Programs continue to run 
  80. normally even when the display is switched off, and their output will be there
  81. when you switch back.  Programs that depend on the alternate screen may not work 
  82. correctly, if at all.
  83.  
  84. Unlike other programs that load in at bootup time, it is essential that 
  85. AutoBlack be first to load -- even before the debugger -- to get access to the 
  86. alternate screen.  INIT files other than AutoBlack often take part of the memory
  87. used by the alternate screen; if they get there first, AutoBlack cannot install
  88. itself.  If it fails to load as an INIT, simply rename it "MacsBug" and try 
  89. again.  Some systems, notably the HyperDrive 2000, rejuggle the memory hardware 
  90. at INIT time; there is no way for AutoBlack to install at the proper time in such 
  91. a wierd system.  Some INITs leave a lot of trash in the heap when they are done;
  92. AutoBlack has been known to crash after such dirty predecessors.  Renaming the
  93. files so AutoBlack loads first usually clears up the problem.
  94.  
  95. NOTICE
  96. AutoBlack¬ is Copyright ⌐ 1987 by Itty Bitty Computers.  Version 1.2 was free,
  97. but I put some extra work into making version 1.5 into an INIT and a double-
  98. clickable program, and also making it work with large screen hardware and 
  99. software.  I'm asking $5 (shareware) if you appreciate AutoBlack and would like 
  100. me to write more useful Mac Software.  AutoBlack may be freely distributed but not for profit, if it is unmodified and this document is included.
  101.  
  102. Itty Bitty¿ is a registered trademark of Itty Bitty Computers.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. -  -  -  -  -  -  -  -  -  -  -  Cut Here  -  -  -  -  -  -  -  -  -  -  -  -
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                      Staple or tape $5 here, 
  123.                      Then fold with this flap inside
  124.                      Tape all edges shut, add stamp,
  125.                      Then drop into any mailbox.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132. -  -  -  -  -  -  -  -  -  -  -  Fold Here  -  -  -  -  -  -  -  -  -  -  -  -
  133. Please Register AutoBlack to:                                         _______
  134.                                                                      |       |
  135. ___________________________                                          | PLACE |
  136. (name)                                                               | STAMP |
  137.                                                                      | HERE  |
  138. ___________________________                                          |_______|
  139. (address)
  140.  
  141. ___________________________ 
  142. (city)        (state)  (zip)
  143.  
  144.  
  145.                                    Itty Bitty Computers
  146.                                    P.O. Box 6539
  147.                                    San Jose, CA  95150-6530
  148.  
  149.  
  150.  
  151.  
  152.  
  153. -  -  -  -  -  -  -  -  -  -  -  Fold Here  -  -  -  -  -  -  -  -  -  -  -  -
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.